Popular Searches
Popular Course Categories
Popular Courses

Step-by-step Flutter SDK installation

Step-by-step Flutter SDK installation

5 mins Flutter Setup & Installation

Step-by-Step Flutter SDK Installation

Flutter SDK installation is the first major step toward developing Flutter applications. The Flutter SDK provides the Flutter framework, Dart SDK, command-line tools, debugging tools, testing tools, and other components required to create and run Flutter applications.

According to the official Flutter documentation, the SDK includes the Dart SDK, Flutter CLI, Flutter DevTools, rendering engine, widgets, testing APIs, and other development tools.


1. What is Flutter SDK?

Flutter SDK stands for Flutter Software Development Kit. It is a collection of tools and libraries provided by Flutter for developing applications from a single codebase.

Flutter applications can target platforms such as Android, iOS, Web, Windows, macOS, and Linux.

Flutter SDK Includes

  • Flutter Framework
  • Dart SDK
  • Flutter Command-Line Interface (CLI)
  • Flutter Widgets
  • Flutter DevTools
  • Testing and debugging tools
  • Build and compilation tools
  • Platform integration APIs

The Flutter SDK also provides the flutter and dart command-line tools used to create, run, test, and build applications.


2. Why Do We Need Flutter SDK?

Installing Flutter SDK gives developers access to the complete Flutter development environment. Without the SDK, commands such as flutter create, flutter run, and flutter doctor will not be available.

Important Reasons

  • To create Flutter projects.
  • To run Flutter applications.
  • To compile Flutter applications.
  • To use Dart programming language with Flutter.
  • To debug applications.
  • To run automated tests.
  • To use Flutter DevTools.
  • To manage Flutter packages and dependencies.

3. Supported Development Platforms

Flutter can be installed on multiple operating systems. The exact prerequisites depend on the platform you want to develop on.

Operating System Flutter Development
Windows Android, Web, Windows
macOS Android, iOS, Web, macOS
Linux Android, Web, Linux
ChromeOS Web and supported development environments

For beginners, Flutter's documentation recommends trying Web development first because it requires less additional platform-specific setup.


4. Prerequisites Before Installing Flutter

Before installing Flutter, make sure your computer has sufficient storage and that the required development tools are available.

Basic Requirements

  • A supported operating system.
  • Internet connection for downloading Flutter and dependencies.
  • Git, when required by the selected installation method.
  • A code editor or IDE such as VS Code or Android Studio.
  • Additional platform-specific tools if developing for Android, iOS, Windows, macOS, or Linux.

For Android development, Android Studio and the Android SDK are commonly used to provide the Android development environment.


5. Download Flutter SDK

The first step is to download the Flutter SDK for your operating system. Always prefer the official Flutter installation page or SDK archive when downloading Flutter.

Official Flutter Installation

Visit the official Flutter installation documentation to choose the appropriate installation method and operating system.

Official Flutter Installation Documentation

Flutter SDK Archive

The Flutter SDK archive can be used when you need a particular Flutter release.

Flutter SDK Archive


6. Installing Flutter SDK on Windows

The following steps explain a traditional manual Flutter SDK installation on Windows.

Step 1: Download the Flutter SDK

Download the Windows Flutter SDK package from the official Flutter website. The downloaded package is generally provided as a compressed archive.

Step 2: Create a Development Folder

Create a folder where the Flutter SDK will be stored. A simple location is:

C:\Users\YourName\develop

Flutter's documentation recommends using a location without unnecessary spaces or special characters and avoiding locations that require elevated permissions.

Step 3: Extract Flutter SDK

Extract the downloaded Flutter archive into your development folder. After extraction, you should have a folder similar to:

C:\Users\YourName\develop\flutter

Inside the Flutter folder, you will find directories and files required by the SDK. One of the most important directories is the bin directory.


7. Understanding the Flutter SDK Folder

A simplified Flutter SDK structure looks similar to this:

flutter/
├── bin/
├── packages/
├── dev/
├── examples/
├── engine/
├── README.md
└── LICENSE

Important Directory: bin

The bin directory contains the command-line tools used to interact with Flutter.

flutter/
└── bin/
    ├── flutter
    └── dart

The flutter/bin directory needs to be added to the system PATH so that Flutter commands can be executed from a terminal.


8. Add Flutter to Windows PATH

Adding Flutter to the PATH allows you to execute Flutter commands from Command Prompt, PowerShell, Windows Terminal, and compatible IDE terminals.

Step 1: Find Flutter bin Path

For example:

C:\Users\YourName\develop\flutter\bin

Step 2: Open Environment Variables

  1. Open Windows Search.
  2. Search for Environment Variables.
  3. Select Edit the system environment variables.
  4. Click Environment Variables.

Step 3: Edit PATH

  1. Under User variables, find Path.
  2. Select Path.
  3. Click Edit.
  4. Click New.
  5. Add the Flutter bin directory.
  6. Click OK to save the changes.

Example:

C:\Users\YourName\develop\flutter\bin

Step 4: Restart Terminal

Close and reopen Command Prompt, PowerShell, Windows Terminal, and IDE terminals so that the new PATH configuration is loaded.


9. Verify Flutter Installation

Open Command Prompt or PowerShell and run:

flutter --version

If Flutter is installed correctly, the terminal should display information about the installed Flutter SDK.

Check Dart

dart --version

Dart is included with the Flutter SDK, so a working Flutter installation should also provide the Dart command-line tool.


10. Run Flutter Doctor

One of the most important commands after Flutter installation is:

flutter doctor

For more detailed information, use:

flutter doctor -v

Flutter Doctor checks your development environment and reports missing dependencies or configuration issues.

Example

Doctor summary:
[✓] Flutter
[✓] Android toolchain
[✓] Chrome
[✓] Visual Studio
[✓] Connected device
[✓] Network resources

The exact output depends on your operating system and the development platforms you have configured.


11. Install VS Code

Visual Studio Code is a lightweight editor that can be used for Flutter development. Flutter provides an official extension for VS Code.

Install Flutter Extension

  1. Open VS Code.
  2. Open the Extensions panel.
  3. Search for Flutter.
  4. Install the Flutter extension.
  5. The Dart extension is also installed or enabled as required.

Flutter's current documentation also provides a VS Code-based installation flow that can download the SDK and add it to PATH.


12. Install Android Studio

If you want to develop Flutter applications for Android, you generally need the Android development environment.

Android Studio Provides

  • Android SDK
  • Android SDK Platform Tools
  • Android Emulator
  • Android SDK Build Tools
  • Android Virtual Device management

After installing Android Studio, open the SDK Manager and make sure the required Android SDK components are installed.


13. Configure Android SDK

After installing Android Studio, Flutter may detect the Android development environment automatically.

Run:

flutter doctor

If Flutter reports missing Android components, follow the instructions displayed by flutter doctor.


14. Accept Android Licenses

For Android development, Flutter may ask you to accept Android SDK licenses. Run:

flutter doctor --android-licenses

Read the license information and accept the required licenses when appropriate.

After completing the process, run:

flutter doctor

15. Configure an Android Emulator

An Android Emulator allows you to run a Flutter application without connecting a physical Android phone.

Basic Process

  1. Open Android Studio.
  2. Open Device Manager.
  3. Create a new Virtual Device.
  4. Select an Android device model.
  5. Select a suitable Android system image.
  6. Complete the configuration.
  7. Start the emulator.

Then verify the connected device:

flutter devices

16. Use a Physical Android Device

Instead of an emulator, you can test Flutter applications on a physical Android device.

Basic Steps

  1. Enable Developer Options on the Android device.
  2. Enable USB Debugging.
  3. Connect the phone to the computer using USB.
  4. Allow the computer when the authorization prompt appears.
  5. Run flutter devices.
flutter devices

If the device is detected correctly, it can be selected as the Flutter application's target device.


17. Create Your First Flutter Project

Once Flutter is installed successfully, you can create a new Flutter project from the terminal.

Command

flutter create my_first_app

This command creates a new Flutter project named my_first_app.

Move Into the Project

cd my_first_app

Run the Application

flutter run

Flutter will build and launch the application on an available target device.


18. Flutter Project Structure

A newly created Flutter application contains several important files and directories.

my_first_app/
├── android/
├── ios/
├── lib/
│   └── main.dart
├── test/
├── web/
├── windows/
├── macos/
├── linux/
├── pubspec.yaml
└── README.md

Important Files

File/Folder Purpose
lib/ Main Dart application source code.
lib/main.dart Common entry point of a Flutter application.
pubspec.yaml Project metadata, dependencies, assets, and configuration.
android/ Android-specific project files.
ios/ iOS-specific project files.
web/ Web-specific project files.
test/ Test files.

19. Write a Simple Flutter Application

Open lib/main.dart and you can create a simple Flutter application.

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('My First Flutter App'),
        ),
        body: const Center(
          child: Text(
            'Hello Flutter!',
            style: TextStyle(fontSize: 24),
          ),
        ),
      ),
    );
  }
}

Run the application using:

flutter run

20. Understanding flutter pub get

Flutter projects use the pubspec.yaml file to define dependencies and project configuration.

When dependencies are added or modified, run:

flutter pub get

This command downloads and resolves the packages specified in the project.


21. Important Flutter Commands

Command Purpose
flutter --version Displays Flutter version.
dart --version Displays Dart version.
flutter doctor Checks the development environment.
flutter doctor -v Displays detailed diagnostic information.
flutter devices Lists available devices.
flutter create project_name Creates a new Flutter project.
flutter run Runs a Flutter application.
flutter pub get Gets project dependencies.
flutter clean Removes generated build files.
flutter upgrade Updates the Flutter SDK.

22. Flutter Installation Using VS Code

Flutter also provides a streamlined installation method through VS Code and other Code OSS-based editors.

Basic Process

  1. Install VS Code.
  2. Install the Flutter extension.
  3. Open the Command Palette.
  4. Select Flutter: New Project.
  5. When prompted for the Flutter SDK, select Download SDK.
  6. Select an installation location.
  7. Allow VS Code to download Flutter.
  8. Select Add SDK to PATH.
  9. Restart VS Code and terminal windows.
  10. Run flutter doctor.

This method is useful for beginners because VS Code can guide the user through the SDK installation and PATH configuration.


23. Flutter Installation on macOS

On macOS, Flutter can be installed manually or through a supported editor-based installation workflow.

Example SDK Location

~/develop/flutter

Add Flutter to PATH

For the default Zsh shell, the Flutter SDK's bin directory can be added to the PATH in the appropriate shell configuration file.

export PATH="$HOME/develop/flutter/bin:$PATH"

After updating the configuration, restart the terminal and verify:

flutter --version
dart --version
flutter doctor

For iOS development, additional Apple development tools such as Xcode are required.


24. Flutter Installation on Linux

On Linux, Flutter can be manually installed by downloading the appropriate SDK archive and extracting it into a suitable directory.

Common Prerequisite Packages

sudo apt-get update
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa

Example SDK Location

~/develop/flutter

Add Flutter to PATH

export PATH="$HOME/develop/flutter/bin:$PATH"

Then verify:

flutter --version
dart --version
flutter doctor

25. Common Flutter Installation Problems

Problem 1: flutter is not recognized

If you see an error similar to:

'flutter' is not recognized as an internal or external command

The Flutter SDK's bin directory may not be correctly added to PATH.

Solution

  1. Find the Flutter SDK location.
  2. Locate the bin folder.
  3. Add the folder to PATH.
  4. Close the terminal.
  5. Open a new terminal.
  6. Run flutter --version.

Problem 2: flutter doctor shows warnings

A warning from flutter doctor does not always mean Flutter itself is incorrectly installed. It may indicate that a particular target platform has not been configured.

For example, if you only want to develop for Web, Android-specific warnings may not prevent Web development.


Problem 3: Android licenses are missing

Run:

flutter doctor --android-licenses

Accept the required licenses and then run:

flutter doctor

Problem 4: Android device is not detected

Try the following:

  • Check USB connection.
  • Enable USB Debugging.
  • Accept the authorization prompt on the phone.
  • Check Android SDK installation.
  • Restart ADB if necessary.
  • Run flutter devices.

Problem 5: Terminal does not recognize updated PATH

After changing PATH, existing terminals may continue using the old environment. Close and reopen the terminal and restart the IDE.


26. Check Flutter Installation Completely

After completing the installation, run the following commands:

flutter --version
dart --version
flutter doctor
flutter devices

Then create a test project:

flutter create test_app
cd test_app
flutter run

If the application launches successfully, your basic Flutter development environment is ready.


27. Flutter PATH Explained

PATH is an environment variable that tells the operating system where executable programs can be found.

When Flutter's bin directory is added to PATH, you can run:

flutter
dart

from different terminal locations without entering the complete SDK path every time.

Without PATH

C:\Users\YourName\develop\flutter\bin\flutter --version

With PATH

flutter --version

Therefore, adding Flutter to PATH makes command-line development much easier.


28. Updating Flutter SDK

Flutter releases updates that may include new features, bug fixes, performance improvements, and compatibility changes.

To update an existing Flutter installation, use:

flutter upgrade

After upgrading, verify the environment:

flutter doctor

When upgrading a project, always review relevant migration information if your application depends on older Flutter APIs or packages.


29. Check Flutter Version

To check the installed Flutter version:

flutter --version

For more detailed information:

flutter doctor -v

30. Flutter Channels

Flutter provides release channels for different development purposes. The exact availability and recommendations can change over time, so developers should consult the official Flutter documentation before switching channels.

For normal application development, the stable channel is generally the appropriate choice.

To check your current channel:

flutter channel

31. Recommended Installation Workflow

  1. Check your operating system.
  2. Install the required prerequisites.
  3. Download the Flutter SDK.
  4. Extract Flutter to a suitable development directory.
  5. Add flutter/bin to PATH.
  6. Restart the terminal.
  7. Run flutter --version.
  8. Run dart --version.
  9. Run flutter doctor.
  10. Install and configure an IDE.
  11. Configure the target platform.
  12. Create a test Flutter project.
  13. Run the project.
  14. Fix any issues reported by flutter doctor.

32. Practical Example: Fresh Flutter Installation

Suppose a developer wants to install Flutter on Windows.

Step 1: Create Development Folder

C:\Users\Student\develop

Step 2: Extract Flutter

C:\Users\Student\develop\flutter

Step 3: Add PATH

C:\Users\Student\develop\flutter\bin

Step 4: Verify

flutter --version
dart --version

Step 5: Diagnose

flutter doctor

Step 6: Create Application

flutter create student_app

Step 7: Open Project

cd student_app

Step 8: Run Application

flutter run

This completes the basic Flutter installation and verification workflow.


33. Installation Checklist

Task Status
Flutter SDK downloaded
Flutter SDK extracted
Flutter bin added to PATH
Flutter version checked
Dart version checked
flutter doctor executed
VS Code installed
Flutter extension installed
Android Studio installed if required
Android SDK configured if required
Android licenses accepted if required
Emulator/device configured
Test Flutter application created
Flutter application successfully executed

34. Important Interview Questions

Q1. What is Flutter SDK?

Flutter SDK is a collection of Flutter libraries, Dart SDK, command-line tools, development utilities, testing tools, and other components required to build Flutter applications.

Q2. What is the purpose of the Flutter bin directory?

The bin directory contains Flutter and Dart command-line tools. Its location is added to PATH so that Flutter commands can be executed from the terminal.

Q3. Why do we add Flutter to PATH?

Adding Flutter to PATH allows the operating system to locate the Flutter command from the terminal without requiring the complete path to the Flutter SDK.

Q4. What does flutter doctor do?

flutter doctor checks the Flutter development environment and reports configuration issues, missing dependencies, and available development tools.

Q5. How can you check the Flutter version?

flutter --version

Q6. How can you create a new Flutter project?

flutter create my_app

Q7. How can you run a Flutter application?

flutter run

Q8. Is Dart installed separately with Flutter?

The Flutter SDK includes the Dart SDK, so installing Flutter provides the Dart command-line tool as part of the Flutter development environment.


35. Key Points to Remember

  • Flutter SDK is required for Flutter application development.
  • The Flutter SDK includes Dart.
  • The flutter/bin directory should be available through PATH for command-line use.
  • flutter --version checks the installed Flutter version.
  • dart --version checks the Dart version.
  • flutter doctor diagnoses the development environment.
  • Android development requires an appropriate Android development environment.
  • iOS development requires macOS and Apple's development tools.
  • VS Code can provide a streamlined Flutter installation workflow.
  • Always restart terminals after modifying PATH.
  • Use flutter devices to check available devices.
  • Use flutter create to create a new project.
  • Use flutter run to run a Flutter application.

36. Flutter Training Resource

For structured Flutter learning, practical development, and guided training, you can explore the Flutter training resource below:

JustAcademy Flutter Training

You can also register for a course demo using the following link:

Register for Flutter Course Demo


37. Conclusion

Installing the Flutter SDK is the foundation of Flutter application development. The complete process involves downloading the SDK, extracting it to a suitable location, configuring PATH, verifying Flutter and Dart, running flutter doctor, setting up an IDE, configuring the desired target platform, and finally creating and running a test application.

Once the installation is successfully verified, you can start learning Dart, Flutter widgets, layouts, navigation, state management, APIs, databases, animations, and complete Flutter application development.

Basic installation workflow:

Download Flutter
      ↓
Extract Flutter SDK
      ↓
Add flutter/bin to PATH
      ↓
flutter --version
      ↓
dart --version
      ↓
flutter doctor
      ↓
Configure IDE
      ↓
Configure Target Platform
      ↓
flutter create my_app
      ↓
flutter run
whatsapp